NAME GU_PostFilterIMsg -- Return the unfiltered message after GU_FilterIMsg() was called, and clean up. SYNOPSIS imsg = GU_PostFilterIMsg(modimsg) D0 A1 struct IntuiMessage *GU_PostFilterIMsg(struct IntuiMessage *); FUNCTION NOTE WELL: Extremely few programs will actually need this function. You almost certainly should be using GT_GetIMsg() and GT_ReplyIMsg() only, and not GT_FilterIMsg() and GT_PostFilterIMsg(). Performs any clean-up necessitated by a previous call to GT_FilterIMsg(). The original IntuiMessage is now yours to handle. Do not interpret the fields of the original IntuiMessage, but rather use only the one you got from GT_FilterIMsg(). You may only do message related things at this point, such as queueing it up or replying it. Since you got the message with exec.library/GetMsg(), your responsibilities do include replying it with exec.library/ReplyMsg(). This function may be safely called with a NULL parameter. INPUTS modimsg - A modified IntuiMessage obtained with GU_FilterIMsg(), or NULL. RESULT imsg - a pointer to the original IntuiMessage, if GT_FilterIMsg() returned non-NULL. NOTES See gadtools/GT_PostFilterIMsg for more information. SEE ALSO GU_FilterIMsg(), gadtools/GT_PostFilterIMsg()
Converted on 19 Jul 1996 with RexxDoesAmigaGuide2HTML by Michael Ranner.